OPENHOUSE FÜR DEN MAC – ERSTE SCHRITTE
=======================================

Openhouse läuft komplett auf Ihrem Mac: Website, Registrierung, Anmeldung,
Verwaltung, Mieterportal und Eigentümerzugang. Ihre Daten bleiben auf diesem Mac.


1. INSTALLIEREN

   Ziehen Sie „Openhouse.app“ in den Ordner „Programme“.


2. DAS ERSTE ÖFFNEN

   Die App ist noch nicht bei Apple beglaubigt. macOS fragt deshalb beim ersten Öffnen nach:

   macOS 15 (Sequoia) und neuer:
     a) Doppelklick auf Openhouse → Meldung mit „Fertig“ schließen.
     b) Systemeinstellungen → Datenschutz & Sicherheit → ganz nach unten scrollen.
     c) Bei „Openhouse wurde blockiert …“ auf „Trotzdem öffnen“ klicken und bestätigen.

   macOS 14 und älter:
     Rechtsklick (oder Ctrl-Klick) auf Openhouse → „Öffnen“ → „Öffnen“.

   Alternativ im Terminal (einmalig):
     xattr -dr com.apple.quarantine /Applications/Openhouse.app

   Beim allerersten Start lädt Openhouse einmalig Node.js von nodejs.org (ca. 45 MB,
   Prüfsumme wird kontrolliert). Das dauert etwa eine Minute. Danach braucht Openhouse
   kein Internet mehr. Ist Node.js 22 schon installiert (z. B. über Homebrew), wird es genutzt.


3. LOSLEGEN

   Openhouse öffnet sich in Ihrem Browser unter http://localhost:4747
     • „Kostenlos testen“ → als Eigentümer oder Hausverwaltung registrieren
     • Die Bestätigungs-E-Mail finden Sie im POSTAUSGANG (Link unten auf jeder Seite
       bzw. links in der Seitenleiste). Diese Version verschickt keine echten E-Mails –
       Bestätigungen, Einladungen an Mieter und Schreiben landen dort.
     • Hausverwaltungen richten beim Start die Zwei-Faktor-Anmeldung ein
       (Authenticator-App, z. B. „Passwörter“ auf dem iPhone).
     • Tipp: „Musterhaus anlegen“ zeigt alle Abläufe mit Beispieldaten.


4. BEENDEN UND WIEDER ÖFFNEN

   • Beenden: in der Seitenleiste auf „Openhouse beenden“.
   • Wieder öffnen: Openhouse im Programme-Ordner doppelklicken.
     Läuft Openhouse schon, öffnet sich einfach der Browser.


5. BANKKONTO VERBINDEN

   Mieteingänge kommen automatisch, sobald Ihr Mietkonto verbunden ist:
     • Bankkonten → „Bankanbindung einrichten“ zeigt Schritt für Schritt, wie Sie einmalig
       einen Zugang bei Enable Banking (zugelassener Kontoinformationsdienst) anlegen.
     • Danach Bank auswählen, bei der Bank anmelden, fertig. Openhouse kann nur lesen,
       nie Geld bewegen.
     • Beim ersten Zurückkommen von der Bank warnt der Browser einmal vor dem Zertifikat
       von „localhost“ – das ist erwartet: „Details einblenden“ → „diese Website besuchen“.
   Ohne Bankanbindung laden Sie Kontoauszüge als CSV hoch (Zahlungen → Kontoauszug
   hochladen) – die Zuordnung funktioniert genauso.


6. WO LIEGEN MEINE DATEN?

   ~/Library/Application Support/Openhouse
     Daten/             Datenbank, hochgeladene Belege, Postausgang, tägliche Sicherungen
     schluessel.env     Ihre persönlichen Schlüssel (nicht weitergeben, nicht löschen)
     einstellungen.env  optional: eigene Einstellungen, z. B. ADMIN_EMAILS=ihre@adresse.de
     openhouse.log      Protokoll, falls etwas nicht startet

   Sichern: diesen Ordner kopieren (z. B. per Time Machine).
   Deinstallieren: App löschen und – wenn gewünscht – den Ordner oben.


7. ONLINE STELLEN (für echte Mieter, Mitarbeiter und E-Mails)

   Für eine öffentliche Website mit echtem E-Mail-Versand braucht Openhouse einen Server
   mit eigener Domain. Das Paket „Openhouse-Website-Server.zip“ enthält alles dafür
   (Docker, automatische HTTPS-Zertifikate). Anleitung: README.md in diesem Paket,
   Abschnitt „Online stellen (Schritt für Schritt)“.


8. MIT IHRER APPLE-DEVELOPER-ID SIGNIEREN (zum Weitergeben)

   Damit die App auf anderen Macs ohne Warnung startet: „Signieren.command“ (liegt neben
   der App) doppelklicken. Das Skript signiert Openhouse.app mit Ihrem Zertifikat
   „Developer ID Application“, lässt sie von Apple beglaubigen (Notarisierung) und legt
   „Openhouse-Mac-signiert.zip“ an. Einmalig nötig: Apple-ID und ein app-spezifisches
   Passwort (appleid.apple.com → Anmelden und Sicherheit).


9. BETREIBER-PANEL

   Wer sich in der Mac-App als Erstes registriert, ist Betreiber: In der Seitenleiste
   steht dann „Betreiber“. Dort sehen Sie alle Nutzer und Konten, neue Registrierungen,
   Umsatz, Aktivität sowie den Stand aller Schlüssel und Dienste.
